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3 ¢ Network Event Logger Definitions 
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++ 

>; FACILITY: DECnet-VAX Network Management Components 

; for Event Logging 

> ABSTRACT: 

: Common Definitions for Network Management Event Logging 

$ These definitions are private to the EVL component. 

: ENVIRONMENT: VAX/VMS Operating System 

> AUTHOR: Darrell Duffy, Tim Halvorsen, 13-June-1980 

> MODIFIED BY: 

; v0O0S = MKP0001 Kathy Perko 27=June- 1984 

s Now that OPCOM can handle more than 256 bytes, increase 
3 the Length fields for opcom message from a byte to a word. 
; v004 — TMHO004 Tim Halvorsen 20-Jul-1983 

; Increase amount of storage allocated for event 

: transmitter NCB. 

; vOO3 —- TMHOO03 Tim Halvorsen 25-Jun-1981 

: Add two event flag symbols. 

; vO0O2 = TMHO002 Tim Halvorsen 20-Nov-1980 
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Change definition of second byte e source data 
structure in the filter database from a sink mask 
to a sink number (which is what NML is using). 


TMHOO001 Tim Halvorsen 17-Nov-1980 
Add descriptor of previous Line output for 
console formatting routines. 


rr 
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3 General definitions 


S$STRUCT EVL 


C < 
SYNCH_EFN,1 ; Evert flag used for synchronous 1/0 
ASYNCR_EFN,2 ; Event flag used for asynchronous 1/0 
MAXEVTCNT,200 ; Maximum number of events in a queue | 
. ; for the transmitter 
E 
: Processed event record structure 


SSTRUCT EVT 


Zz > 


| 
F FUNCTION,B ; Function code (= 1) e 
F FLAGS ,B : Indicates which sinks receive record 
4 CODE. ; Event code 
TYPE ,6 ; Event ree within class (see EVCDEF) | 
CLASS.9 ; Event class (see EVCDEF) 
> : 
F JULIAN, W ; Time: Julian half-days since 1-Jan-77 : 
F SECONDS ,W 3 Second within half-day : 
F MSECS,W ; Milliseconds within second ; 
F SRCADR,W ; Source node address ; 
F SRCNAMLEN,B ; Source node name Length | ; 
§ SRCNAM,T,{ ; Source node name string (max 6 bytes) ; € 
; Event ont ty follows ype and | ; 
; ; Event specific data follows ; 
' 
i 
i 
i 
i 


| 
E1 
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Data block descriptor 


SSTRUCT DBK | 


fF FL ; Forward Link in queue 
F BL ; Backward Link in queue 
F SIZE ,W ; Size of structure 

t SIZE 


Event Queue block 


SSTRUCT Eva 


f FL 3; Forward Link 

F BL ; Backward Link 

f SIZE,W ; Size of structure 

F EVTSIZE.W ; Bytes in the event 
F EVENT,T,O ; Start of event data 
L SIZE 


EVLDEF .MDL;1 
3 Structures used in the event transmitter 
: AST Parameter Control Block 
| P 
)$SSTRUCT ASP 
f FLL L 3; Forward Link 
f BL, L 3 Backward Link 
f SIZE, s 3; Size of structure 
fF NETCHAN, W ; Channel to net device 
F 10SB, W ; 10 status block 
F 10sB{, ; Remainder of iosb 
F 10SBz2 
é ROUTINE, ; address of routine to perform 
F DATA, T, ; Data area address 
L SIZE 
E 
; Sink control block structure, provides the context for 
; the outgoing logical Links from the event transmitter. 
SSTRUCT SNK 
F ri. & ; Forward Link 
fF BL, L ; Backward Link 
F SIZE, wW ; Size of structure 
F NETCHAN, W ; Channel to net device 
Ff 10SB, @ ; 10 status block 
F 10SBi, bd ; Remainder of iosb 
fF 10SB2, L 
f ROUTINE, L ; address of routine to perform 
7 SNKADR, L ; Address of sink node 
e SRCFL, L ; Head of source List 
F SRCBL, L 
Ff EVTFL, L ; Head of event queue 
is EVTBL, L 
F EVTCNT, WW ; Number of events on the queue 
j SrATUS. 8 ; Status of logical Link to node 
ST 3; Link is open 
STS. ; Some action in progress 
STS ; Back door in use 
ST ; Delete on close 
ST 3; Close and delete 


Close on non-use timer outstanding 


3; Sink mask for lost events 
; Descriptor of ncb 


NCB of Link 
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Source descriptor block 


| 
| 
SSTRUCT SRC | 
F FL, L ; Forward Link | 
F BL, L ; Backward Link 
F SIZE, w ; Size of structure | 
fF SNKTYPE, 8B ; Sink type 
Ff SRCTYP, B ; Source type code 
F SRCID, T, 18 ; Source name 
F FILTERS, W : Number of filters 
f FILTERS, T, 0 ; Start of filters 
L SIZE 
| 
: Filter descriptor | 
’ 
$STRUCT FLT | 
J CLASS. iw 3; Class of event | 
CLASS, 9¥ ; Class code | 
wLOcoD, 2 3 Wild card code | 
F Ww 3; Filler | 
F TYPESLOG, 0 ; Type mask to Log | 
F TYPESFIL, Q 3; Type mask to filter 
t SIZE 


F 
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SSTRUCT SINK 


< 

ACTIVE 254 
KNOWN, 255 

CONSOLE 1 

FILE 


MONITOR. 3 
STATE,B 

< 

ON 

OFF 

HOLD 
EVENTS, W 
EVTFL 


< 

DELETE 
ERROR 

.B,1 
MAXBUFSIZ,W 
BUFLEN,W 
BUFFER 

RAB 

CHANNEL ,O,W 
CLOSERTN 
10SB,W 
10584 ,wW 
10$82.L 
NAMELEN : 
NAME .1,255 
LENGTH 


Define incoming event channel context block 
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g Define structures used by the receiver 


5 Define sink type descriptor block 


Queue Links 
Type of sink 


Active sink types 
Known sink types 
Console sink 

File sink 

Monitor process sink 


Sink is on 
Sink is off, ignore all events 
Sink is holding all events until turned on 


Number of events on queue 
Queue head of event data blocks 


Flags 


Indicates sink should be deleted when the 
events queued for this sink are output 


error’’ state; all events are ignored to 
this sink until a data base change 


Maximum size of buffer (OPCOM monitor only) 
Bytes current hy in buffer (OPCOM monitor only) 
Address of buffer (OPCOM monitor onty? 
Address of RAB/FAB storage block (file only) 
Channel for 1/0 (monitor only) 
Address of routine to perform close 

nonzero if sink has been initialized 
1/0 status block specific to this sink 


Length of sink name string 
Sink name oyrine 
Length of sink descriptor block 
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SSTRUCT IEC 


f LINK ; Forward Link 

F BLINK 3; Backward Link 

5 SIZE .W ; Size of qcire structure 
F CHAN ,W ; Network atonres channel number 
. osB ; 1/0 status bloc 

F 10S8{ ,w 

f OSB2, 

F + a B ; Length of NCB 

F ° ; NCB for incoming Link 

C MAXNCBLEN 

ia EVENT,1,25 ; Buffer for event record 

C MAXEVTLEN, 250 

‘ TH ; Fixed length of structure 
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; Define the bits for controlling messages to the batch log 
; of the event processor. 


SSTRUCT ELG 


Vv <A 
DBUPDAT, 1 ; Data base updates for transmit or receive 
NKOPN, 1 ; Link to sink node opened 

RCVCCF, 1 ; Link confirmed by receiver 

1 3; Link opened to event monitor 
RAWEVT, 1 ; Text of raw event 
QUEEVT, 1 ; Text of event queued to sink 
RCVEVT, 1 ; Text of event received by receiver 
> 
E 
; Counter descriptor List entry 
SSTRUCT CTB 
Ff PCODE, W ; Parameter code for counter 
F OFFSET, wl 3; Offset in counter block 
f WIDTH, B 3; Width of counter in bits 
F A ; True for accumulate counter 
F BITMAP, Ww ; Bitmap mask for this counter 
L SIZE ; Total size of structure 
E 
: Line id conversion table entry 
SSTRUCT VDL 3; VMS to DNA Line table 


; Address of vms name counted string 
; Address of dna name counted string 
; Type mask for 


F 
F 


3; point to point Lines 
; multiplexed ' nes 
; multipoint Lines 


Ynit/teioutery coefficient 
; Unit = vms unit / coef 
trib = vms unit mod coef 

; size of structure 


— — SSS 


10 


‘END 
tELUt 
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; 10SB fields 


SSTRUCT 10SB 


nea 


End of EVLDEF .MDL 


Abas {| ateeus 
Normally size of transfer 
Secondary status 


; Tertiary status 
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